home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / slqwk102.zip / SLQWIK.DOC < prev    next >
Text File  |  1992-02-21  |  16KB  |  592 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                 SLQWiK 1.10
  16.  
  17.               Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  18.  
  19.                Created with the Searchlight Programmer's Library
  20.                Portions Copyright (c) 1991 Searchlight Software
  21.  
  22.                         New Files List by Kevin Bass
  23.                      Copyright (c) 1991 BiBass Software
  24.  
  25.                      Designed & Written by Jack Ridgway
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.                                   Page 1
  58.  
  59.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.    CONTENTS
  67.  
  68.      Disclaimer .....................................................  3
  69.  
  70.      Shareware Agreement ............................................  3
  71.  
  72.      What Does SLQWiK Do? ...........................................  4
  73.  
  74.      Distribution Archive Contents ..................................  4
  75.  
  76.      Additional Files ...............................................  4
  77.  
  78.      Installation ...................................................  5
  79.  
  80.      Using SLQSetup .................................................  6
  81.  
  82.      How To Run SLQWiK ..............................................  8
  83.  
  84.      Local Use ......................................................  9
  85.  
  86.      SLQWIK.SYS .....................................................  9
  87.  
  88.      Registration ................................................... 10
  89.  
  90.      Support - Bug Reports .......................................... 10
  91.  
  92.      Acknowledgements ............................................... 10
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                   Page 2
  117.  
  118.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.    DISCLAIMER
  126.  
  127.      Users of SLQWiK must accept this disclaimer of warranty: "SLQWiK is
  128.      supplied as is.  The author disclaims all warranties, expressed or
  129.      implied, including, without limitation, the warranties of
  130.      merchantability and of fitness for any purpose.  The author assumes
  131.      no liability for damages, direct or consequential, which may result
  132.      from the use of SLQWiK."
  133.  
  134.  
  135.    SHAREWARE AGREEMENT
  136.  
  137.      SLQWiK is a "shareware program" and is provided at no charge to the
  138.      user for evaluation.  Feel free to share it with your friends, but
  139.      please do not give it away altered or as part of another system.
  140.      The essence of "user-supported" software is to provide personal
  141.      computer users with quality software without high prices, and to
  142.      also provide incentive for programmers to continue to develop new
  143.      products.
  144.  
  145.      If you find this program useful and find that you are using it and
  146.      continue to use it after a reasonable trial period of forty-five
  147.      days, then you must register it.  The registration fee will license
  148.      one copy for use on any one computer at any one time.  You must
  149.      treat this software just like a book.  An example is that this
  150.      software may be used by any number of people and may be freely
  151.      moved from one computer location to another, so long as there is no
  152.      possibility of it being used at one location while it's being used
  153.      at another.  Just as a book cannot be read by two different persons
  154.      at the same time.
  155.  
  156.      Commercial users of SLQWiK must register and pay for their copies
  157.      of SLQWiK within forty-five days of first use or their license to
  158.      use SLQWiK is withdrawn.  A BBS operated for profit IS a commercial
  159.      environment; however, a subscription system not operated for profit
  160.      is not considered a commercial environment in relation to this
  161.      agreement.  Site-License arrangements may be arranged by contacting
  162.      A.B.S.
  163.  
  164.      Anyone distributing SLQWiK for any kind of remuneration must first
  165.      contact A.B.S. at the address listed below for authorization.  This
  166.      authorization will be automatically granted to distributors
  167.      recognized by the (ASP) as adhering to its guidelines for shareware
  168.      distributors, and such distributors may begin offering SLQWiK
  169.      immediately; however, A.B.S. must still be advised so that the
  170.      distributor can be kept up-to-date with the latest version of
  171.      SLQWiK.
  172.  
  173.  
  174.  
  175.                                   Page 3
  176.  
  177.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.    WHAT DOES SLQWiK DO?
  185.  
  186.      SLQWiK is the complete off-line mail door for Searchlight.  It now
  187.      supports QWK and Text packets, other types will be added in the
  188.      future.
  189.  
  190.      SLQWiK allows users to download their new messages and read/reply
  191.      off-line, using almost any .QWK reader.  There are MANY .QWK
  192.      readers available, including readers for operating systems other
  193.      than MS-DOS.
  194.  
  195.      SLQWiK creates .QWK packets from the SL message bases, and reads in
  196.      .REP packets.  It follows the industry standard QWK mail format.
  197.      It can optionally include welcome, news, and goodbye screens
  198.      designed by the SysOp.  SLQWiK supports both old style and new
  199.      style command messages.
  200.  
  201.      In Text mode, SLQWiK allows users to download their new messages in
  202.      a text file, no off-line replies are possible.
  203.  
  204.      An optional new files listing can be downloaded with either format.
  205.  
  206.  
  207.    DISTRIBUTION ARCHIVE CONTENTS
  208.  
  209.      You will find the following files in SLQWK110.???:
  210.  
  211.      SLQWIK.EXE   - Main SLQWiK Executable
  212.      SLQSETUP.EXE - SLQWiK Setup/Configuration Program
  213.      SLQWIK.SYS   - Language File Containing All Text in SLQWiK
  214.      README.DOC   - Important Information About SLQWiK
  215.      SLQWIK.DOC   - This Documentation
  216.      SLQUSER.DOC  - User Documentation to put Online for Download
  217.      COMMAND.DOC  - Additional User Documentation - Lists SLQWiK Commands
  218.      WHATS.NEW    - What's New Since 1.00
  219.      REGISTER.FRM - A.B.S. Registration Form
  220.      BETAS.ABS    - Support & Beta Site List
  221.  
  222.  
  223.    ADDITIONAL FILES
  224.  
  225.      SLQSetup will create the following files when first run:
  226.  
  227.      SLQWIK.CFG    - SLQWiK Configuration File
  228.      SLQWIK.USR    - User Configuration File
  229.  
  230.  
  231.  
  232.  
  233.  
  234.                                   Page 4
  235.  
  236.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.      The following files MUST be in your path for SLQWiK to run:
  244.  
  245.      PKZIP.EXE     - Used to Archive QWK & Text Packets
  246.      PKUNZIP.EXE   - Used to UnArchive REP Packets
  247.      DSZ.COM       - Used to Download/Upload Packets.  SLQWiK will
  248.                      search for GSZ.EXE if DSZ.COM is not found.
  249.  
  250.  
  251.    INSTALLATION
  252.  
  253.      SLQWiK will run on any system running MS-DOS 3.3 or higher with at
  254.      least 384K free RAM.  With swapping enabled, SLQWiK requires
  255.      approximately 200K free RAM.
  256.  
  257.      SLQWiK is multi-tasker aware.  It will write to the virtual screen
  258.      if a supported multi-tasker is detected, and it will give up time
  259.      slices while waiting for user input.
  260.  
  261.      SLQWiK (as well as most of my programs) requires an environment
  262.      variable to function properly.  This environment variable is also
  263.      used by other programs (including some by Searchlight Software).
  264.      It is SLBBS=[path to config.sl2 for this node].  This makes
  265.      multi-node usage easy.
  266.  
  267.      If your node 1 config.sl2 is in D:\BBS1 then you would put
  268.      SET SLBBS=D:\BBS1 in your batch file that runs that node.
  269.      IMPORTANT - for multi-node systems, you must have a separate
  270.      SLBBS environment variable for each node.  It should be set in
  271.      the batch file that runs that node!  For single node systems,
  272.      you may put it in your autoexec.bat.
  273.  
  274.      If you're running multi-node, you can make sure that the correct
  275.      config.sl2 file is loaded by running SLQWiK from a batch file
  276.      similar to this:
  277.  
  278.      SLQWIK.BAT
  279.      echo off
  280.      set slbbs=[path to config.sl2 for this node]
  281.      slqwik
  282.  
  283.      Place SLQWiK into its own directory, and place all of its files
  284.      there.  If it can't find its files, it will abort.  SLQWiK also
  285.      will look for PKZIP.EXE, PKUNZIP.EXE, and DSZ.COM or GSZ.EXE in
  286.      your path.
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.                                   Page 5
  294.  
  295.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.      Run SLQSETUP.EXE.  This will write the default configuration files
  303.      that SLQWiK needs to run.  You can then customize the configuration
  304.      for your BBS.  Read the SLQSETUP section for more information.
  305.  
  306.      For more information on how SLQWiK works, see the SLQUSER.DOC.
  307.  
  308.  
  309.    SLQSETUP
  310.  
  311.      SLQSetup is a menu driven setup program for SLQWiK.
  312.  
  313.  
  314.      Configure - General Configuration Options
  315.  
  316.  
  317.        BBS Info - General BBS Information
  318.  
  319.  
  320.          BBSID - 1-6 letters, used for the QWK/REP file name
  321.  
  322.          SysOp Name - Your name, must be the same as registered, case
  323.                       is important
  324.  
  325.          City, State, Country - BBS City, State, Country
  326.                                 All are optional
  327.  
  328.          BBS Phone # - BBS Phone Number
  329.  
  330.          Show ALL Subboards - 'Y' makes SLQWiK follow the specs, and
  331.                               show ALL subboards to the user, whether
  332.                               or not they have access.  'N' only shows
  333.                               the user the subboards they have read
  334.                               access to.  This option ONLY affects what
  335.                               the user SEES in his reader.
  336.  
  337.          Rename SysOp - 'Y' renames 'SYSOP' to the above SysOp Name on
  338.                         export and renames the above SysOp Name to
  339.                         'SYSOP' on import
  340.  
  341.          Strip Tear Lines - 'Y' causes all occurences of a tear line in
  342.                             in a message to be deleted.  A tear line is
  343.                             defined as three dashes ('---') starting at
  344.                             the first character of a line, and followed
  345.                             by a space or a return/line feed.  This
  346.                             helps keep the Fido Gods happy.
  347.  
  348.  
  349.  
  350.  
  351.  
  352.                                   Page 6
  353.  
  354.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.          Disable Tag Line - Disables the SLQWiK Tag Line at the bottom
  362.                             of all imported messages - for registered
  363.                             versions only
  364.  
  365.          Enable Swapping - Enable swapping for external modules (PKZIP,
  366.                            DOS Shell, etc.)
  367.  
  368.          Use EMS - Use EMS for swapping
  369.  
  370.          Use XMS - Use XMS for swapping
  371.  
  372.  
  373.        File Paths - Path Names for files
  374.  
  375.  
  376.          Local Download Directory - Directory where .QWK packets will be
  377.                                     placed during a local download
  378.  
  379.          Local Upload Directory - Directory where .REP packets will be
  380.                                   read in during a local upload.  Local
  381.                                   REPs are NOT deleted, remember to
  382.                                   delete them after import, to avoid
  383.                                   dupes
  384.  
  385.          Path for Swapping to Disk - Directory where the swap file will
  386.                                      be written if swapping to disk
  387.  
  388.  
  389.        Maximum Messages - Maximum Messages Settings by Baud Rate
  390.  
  391.  
  392.          Max Msgs Subboard - Maximum Number of Messages that can be
  393.                              exported on each Subboard
  394.  
  395.          Max Msgs Total - Total Maximum Number of Messages that can be
  396.                           exported
  397.  
  398.          User Override - 'Y' overrides the user's setting if they
  399.                          specify more than the Max Sub or Max Total
  400.                          'N' allows the user to specify anything they
  401.                          want in these fields
  402.  
  403.          Active - 'N' locks out that baud rate from using the door
  404.  
  405.  
  406.        System Shell - Shell to DOS
  407.  
  408.  
  409.  
  410.  
  411.                                   Page 7
  412.  
  413.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.      Register - Registration Information
  421.  
  422.  
  423.        How to Register - Registration Information Screen
  424.  
  425.        Enter Reg. Number - Enter Your Registration Info
  426.  
  427.        Print Reg. From - Print out the Registration form to PRN
  428.  
  429.  
  430.      Edit Users - User Configuration Editor (not implemented yet)
  431.  
  432.  
  433.    HOW TO RUN SLQWiK
  434.   
  435.      SLQWiK will be run from your doors.def file.  The entry is:
  436.  
  437.      2;0;0;[min. access];[door name];[path to SLQWiK];slqwik.exe
  438.  
  439.      The third zero is VERY important!
  440.  
  441.      for example:
  442.  
  443.      2;0;0;5;SLQWiK Off-line Mail Door;d:\doors\slqwik;slqwik.exe
  444.  
  445.      Anyone with access level >= 5 can access the door, and the door is
  446.      located in d:\doors\slqwik
  447.  
  448.      Under SL 2.25, SLQWiK can be added to a menu as a door.  The
  449.      settings are:
  450.  
  451.      1-9 - your preference
  452.  
  453.      10  - SLQWIK.EXE
  454.  
  455.      11  - [path to SLQWIK.EXE]
  456.  
  457.      12  - Force-Color
  458.  
  459.      13  - None
  460.  
  461.      14  - No
  462.  
  463.      15  - None
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                                   Page 8
  472.  
  473.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.    LOCAL USE
  481.  
  482.      To upload a packet locally, copy the .REP packet into the Local
  483.      .REP directory, as defined in SLQSETUP, and run the door (it can
  484.      only be run from SL).  It will detect that you are local, and when
  485.      you go to 'U'pload the packet, it will find it.  SLQWiK will NOT
  486.      delete the .REP file, this is up to you!
  487.  
  488.      To download a packet locally, just run the door.  Your .QWK packet
  489.      will be placed in the Local .QWK directory, as defined in SLQSETUP,
  490.      when the door is finished.  It is your responsibility to delete old
  491.      packets.
  492.  
  493.  
  494.    SLQWIK.SYS
  495.  
  496.      A.B.S. has developed a system similar to the STRINGS.SYS file that
  497.      Searchlight uses.  This allows the SysOp to completely customize
  498.      the Text of SLQWiK (and other A.B.S. software supporting LangSys).
  499.      LangSys is a separate (free) utility that compiles/decompiles
  500.      A.B.S. language files.
  501.  
  502.      When SLQWIK.SYS is decompiled using LangSys, a text file,
  503.      SLQWIK.LNG, is produced.  This file resembles a decompiled
  504.      STRINGS.SYS.  It may be edited with any text editor.
  505.  
  506.      The primary purpose of this file is to allow SLQWiK to be ported
  507.      to other languages; however, it allows the SysOp to change
  508.      virtually all the text in SLQWiK.  The maximum length for a prompt
  509.      string is 12 characters.  The maximum length for all other strings
  510.      is 40 characters.  Please observe these guidelines when editing
  511.      SLQWIK.LNG.  Also, please note that changing some strings can
  512.      cause odd formatting of output.
  513.  
  514.      Programmers interested in using LangSys should contact A.B.S.
  515.      The specs will be given out at no charge, as well as Turbo Pascal
  516.      source to use a language file in any program.
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                                   Page 9
  531.  
  532.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.    REGISTRATION
  540.  
  541.      SLQWiK is distributed as ShareWare.  There is a trial period of
  542.      forty-five days in which you may evaluate SLQWiK.  At the end of
  543.      forty-five days, if you do not register SLQWiK, then you may not
  544.      continue using it.  Please read the DISCLAIMER & SHAREWARE
  545.      AGREEMENT earlier in the documentation for more information.
  546.  
  547.      To Register SLQWiK, fill out the enclosed registration form!
  548.  
  549.  
  550.    SUPPORT - BUG REPORTS
  551.  
  552.      A.B.S.
  553.      P.O. Box 55647
  554.      Jackson, MS 39296-5647
  555.  
  556.      The Big Bang Theory BBS
  557.      SysOp: Jack Ridgway
  558.      601-366-1664
  559.      USR Dual Standard
  560.  
  561.      CIS - 70740,450
  562.      SLBBS - J RIDGWAY
  563.      GEnie - J.RIDGWAY4
  564.      SL_Net - 250:302/532
  565.      FidoNet - 1:3632/4
  566.  
  567.  
  568.    ACKNOWLEDGMENTS
  569.  
  570.      * MS-DOS is a registered trademark of Microsoft Corporation
  571.      * PKZip & PKUnZip are registered trademarks of PKWARE Inc.
  572.      * DSZ.COM/DSZ.EXE/GSZ.EXE are copyrighted by Omen Technology INC
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.                                   Page 10
  590.  
  591.       SLQWiK 1.10 Copyright (c) 1991,1992 A.B.S. - ALL RIGHTS RESERVED
  592.